<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
    <meta http-equiv="Content-Style-Type" content="text/css" />
    <meta name="GENERATOR" content="Quadralay WebWorks Publisher Professional Edition 7.0.2.1206" />
    <meta name="TEMPLATEBASE" content="book-w-index" />
    <meta name="LASTUPDATED" content="10/31/02 16:27:12" />
    <title>Build Targets</title>
    <link rel="StyleSheet" href="document.css" type="text/css" />
    <link rel="StyleSheet" href="catalog.css" type="text/css" />
    <link rel="Table of Contents" href="index.html" />
    <link rel="Previous" href="build.html" />
    <link rel="Next" href="appx-config-opts.html" />
    <link rel="Index" href="portIX.html" />
  </head>

  <body>

    <table class="full-width" id="SummaryNotReq1">
      <tr><td class="sun-darkblue">&#160;</td></tr>
      <tr><td class="sun-lightblue">&#160;</td></tr>
      <tr><td class="go-right">
        <a accesskey="c" href="index.html">
          <img id="LongDescNotReq1" src="images/toc.gif" border="0"
            alt="Contents" /></a>
	<a accesskey="p" href="build.html">
	  <img id="LongDescNotReq2" src="images/prev.gif" border="0"
            alt="Previous" /></a>
        <a accesskey="n" href="appx-config-opts.html">
	  <img id="LongDescNotReq3" src="images/next.gif" border="0"
            alt="Next" /></a>
        <a accesskey="i" href="portIX.html">
	  <img id="LongDescNotReq4" src="images/index.gif" border="0"
            alt="Index" /></a>
        </td>
      </tr>
    </table>

<a name="wp1000944"> </a><h2 class="pAppxNum">
Appendix &#160; A
</h2>
<a name="wp1000008"> </a><h2 class="pNewHTMLPage">
Build Targets
</h2>
<hr class="pHr"/>
<a name="wp1000962"> </a><p class="pBody">
This appendix lists some targets available for building the MIDP Reference Implementation. Many targets that operate on the source files are in the top-level makefile, <code class="cCode">GNUmakefile</code>. The file is in the directory <em class="cEmphasis">midpInstallDir</em><code class="cCode">\build\</code>win32\kvm on Windows 2000 and <br /><em class="cEmphasis">midpInstallDir</em><code class="cCode">/build/linux</code> or <em class="cEmphasis">midpInstallDir</em><code class="cCode">/build/solaris</code> on a UNIX<sup class="cSuperscript">&#174;</sup> platform.
</p>
<a name="wp1001127"> </a><p class="pBody">
The targets that create API documentation are in either the makefile <em class="cEmphasis">midpInstallDir</em><code class="cCode">\build\share\makefiles\Docs.gmk</code> or the makefile <em class="cEmphasis">midpInstallDir</em><code class="cCode">\build\share\makefiles\Release.gmk</code>. The build environment uses the Javadoc&#8482; software to create documentation targets.
</p>
<a name="wp1001599"> </a><p class="pBody">
This chapter divides the targets into the following topics:
</p>
<ul class="pBullet1"><a name="wp1001600"> </a><div class="pBullet1"><li><a  href="appx-targets.html#wp1001129"><span style="color: #3366CC">Basic Build Targets</span></a></li></div>
<a name="wp1001628"> </a><div class="pBullet1Last"><li><a  href="appx-targets.html#wp1001212"><span style="color: #3366CC">Advanced Build Targets</span></a></li></div>
</ul>
<a name="wp1001129"> </a><h2 class="pHeading1">
A.1	Basic Build Targets
</h2>
<a name="wp1001133"> </a><p class="pBody">
The following table describes the main build targets for the MIDP Reference Implementation build environment.</p><div align="left">
<table border="0" cellpadding="7"   id="SummaryNotReq1001134">
  <caption><a name="wp1001140"> </a><div class="pTableCaption">
TABLE&#160;8&#160;&#160;&#8211;&#160;&#160;Basic Build Targets &#160;
</div>
</caption>
<thead>
<tr  align="center">    <th  class="sun-verylightblue" scope="col"><a name="wp1001146"> </a><div style="text-align: left" class="pTableHead">
Target
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp1001148"> </a><div style="text-align: left" class="pTableHead">
Purpose
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp1001150"> </a><div style="text-align: left" class="pTableHead">
Description
</div>

</th>
</tr>
</thead>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
all<a name="wp1001152"> </a>
</pre></div>
</td>
    <td><a name="wp1001154"> </a><div class="pTableText">
Release bundle
</div>
</td>
    <td><a name="wp1001159"> </a><div class="pTableText">
Creates a MIDP Reference Implementation executable and builds the examples. This is the default target.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp1004695"> </a><div class="pTableText">
auction
</div>
<a name="wp1004696"> </a><div class="pTableText">
audiodemo
</div>
<a name="wp1004697"> </a><div class="pTableText">
demos
</div>
<a name="wp1004698"> </a><div class="pTableText">
fonts
</div>
<a name="wp1004699"> </a><div class="pTableText">
games
</div>
<a name="wp1004700"> </a><div class="pTableText">
manyballs
</div>
<a name="wp1004701"> </a><div class="pTableText">
photoalbum
</div>
<a name="wp1004850"> </a><div class="pTableText">
pushpuzzle
</div>
<a name="wp1004703"> </a><div class="pTableText">
stock
</div>
</td>
    <td><a name="wp1004705"> </a><div class="pTableText">
Release bundle
</div>
</td>
    <td><a name="wp1004707"> </a><div class="pTableText">
Builds the named example.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
example<a name="wp1001162"> </a>
</pre></div>
</td>
    <td><a name="wp1001164"> </a><div class="pTableText">
Release bundle
</div>
</td>
    <td><a name="wp1001166"> </a><div class="pTableText">
Builds all of the examples.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
classes.zip<a name="wp1004814"> </a>
</pre></div>
</td>
    <td><a name="wp1004816"> </a><div class="pTableText">
Release bundle
</div>
</td>
    <td><a name="wp1004818"> </a><div class="pTableText">
Compiles and preverifies Java programming language files.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
clean<a name="wp1001174"> </a>
</pre></div>
</td>
    <td><a name="wp1001176"> </a><div class="pTableText">
Preparation for creating a new build.
</div>
</td>
    <td><a name="wp1001178"> </a><div class="pTableText">
Removes all the class files, object files, and other temporary build files from the MIDP Reference Implementation build environment. It does not remove virtual machine (VM) tools or cryptographic object files.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
reallyclean<a name="wp1001183"> </a>
</pre></div>
</td>
    <td><a name="wp1001185"> </a><div class="pTableText">
Preparation for creating a new build.
</div>
</td>
    <td><a name="wp1004808"> </a><div class="pTableText">
Removes everything in the <code class="cCode">clean</code> target, plus the contents of the <em class="cEmphasis">midpInstallDir</em><code class="cCode">\build\appdb</code> storage directory and all VM tools. It does not remove VM tools or cryptographic object files.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
insanelyclean<a name="wp1001189"> </a>
</pre></div>
</td>
    <td><a name="wp1001191"> </a><div class="pTableText">
Preparation for creating a new build.
</div>
</td>
    <td><a name="wp1001193"> </a><div class="pTableText">
Removes everything in the <code class="cCode">reallyclean</code> target and all crytographic object files.
</div>
<a name="wp1001194"> </a><div class="pTableText">
&#160;
</div>
<a name="wp1001195"> </a><div class="pTableText">
<b class="cBold">Note</b>: Do not use the <code class="cCode">insanelyclean</code> target unless you have the SSL source files supplied under special agreement with Sun Microsystems. If you use this target but do not have access to the cryptographic source, you will not be able to rebuild the MIDP Reference Implementation executable without reinstalling MIDP Reference Implementation.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
docs_html<a name="wp1004686"> </a>
</pre></div>
</td>
    <td><a name="wp1004688"> </a><div class="pTableText">
Documentation
</div>
</td>
    <td><a name="wp1004690"> </a><div class="pTableText">
Generates the API reference documentation in HTML for the MIDP Reference Implementation and CLDC classes. 
</div>
</td>
</tr>
<tr><td colspan="15"><hr class="pTableHr" /></td></tr>
</table>
</div>
<p class="pBody">

</p>
<a name="wp1001212"> </a><h2 class="pHeading1">
A.2	Advanced Build Targets
</h2>
<a name="wp1001213"> </a><p class="pBody">
The following table describes some special-purpose targets for creating release documentation and bundles for external use. These build targets are not typically used. For example, the targets that create release bundles are intended to meet the needs of the expert group deploying the specification and the initial reference implementation.</p><div align="left">
<table border="0" cellpadding="7"   id="SummaryNotReq1001214">
  <caption><a name="wp1001219"> </a><div class="pTableCaption">
TABLE&#160;9&#160;&#160;&#8211;&#160;&#160;Advanced Build Targets &#160;
</div>
</caption>
<thead>
<tr  align="center">    <th  class="sun-verylightblue" scope="col"><a name="wp1001225"> </a><div style="text-align: left" class="pTableHead">
Target
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp1001227"> </a><div style="text-align: left" class="pTableHead">
Target Purpose
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp1001229"> </a><div style="text-align: left" class="pTableHead">
Description
</div>

</th>
</tr>
</thead>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
midp-src<a name="wp1001231"> </a>
</pre></div>
</td>
    <td><a name="wp1001233"> </a><div class="pTableText">
Release bundle
</div>
</td>
    <td><a name="wp1001235"> </a><div class="pTableText">
Creates a source bundle that includes the MIDP Reference Implementation reference implementation source code.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
midp-docs<a name="wp1001240"> </a>
</pre></div>
</td>
    <td><a name="wp1001242"> </a><div class="pTableText">
Documentation
</div>
</td>
    <td><a name="wp1001244"> </a><div class="pTableText">
Creates a documentation bundle that includes the combined CLDC and MIDP Reference Implementation API reference documentation.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
midp-dist<a name="wp1001249"> </a>
</pre></div>
</td>
    <td><a name="wp1001251"> </a><div class="pTableText">
Release bundle
</div>
</td>
    <td><a name="wp1001253"> </a><div class="pTableText">
Creates a release bundle that includes a MIDP Reference Implementation executable and reference implementation.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
docs_all<a name="wp1001258"> </a>
</pre></div>
</td>
    <td><a name="wp1001260"> </a><div class="pTableText">
Documentation
</div>
</td>
    <td><a name="wp1001262"> </a><div class="pTableText">
Generates the API reference documentation in HTML for the MIDP Reference Implementation and CLDC classes, including their private fields and methods.
</div>
</td>
</tr>
  <tr align="left">    <td><div class="pPreformatted"><pre class="pPreformatted">
docs_mid<a name="wp1001267"> </a>
</pre></div>
</td>
    <td><a name="wp1001269"> </a><div class="pTableText">
Documentation
</div>
</td>
    <td><a name="wp1001271"> </a><div class="pTableText">
Generates the API reference documentation in HTML for the MIDP Reference Implementation classes.
</div>
<a name="wp1001275"> </a><div class="pTableText">
&#160;
</div>
<a name="wp1001276"> </a><div class="pTableText">
Because this target does not create API documentation for CLDC, it does not include links to CLDC classes and methods. 
</div>
</td>
</tr>
<tr><td colspan="15"><hr class="pTableHr" /></td></tr>
</table>
</div>
<p class="pBody">

</p>

    <p>&#160;</p>
    <hr class="pHr" />

    <table class="full-width" id="SummaryNotReq2">
      <tr>
        <td class="go-left">
          <a accesskey="c" href="index.html">
	    <img id="LongDescNotReq1" src="images/toc.gif" border="0"
              alt="Contents" /></a>
	  <a accesskey="p" href="build.html">
	    <img id="LongDescNotReq2" src="images/prev.gif" border="0"
              alt="Previous" /></a>
	  <a accesskey="n" href="appx-config-opts.html">
	    <img id="LongDescNotReq3" src="images/next.gif" border="0"
              alt="Next" /></a>
	  <a accesskey="i" href="portIX.html">
	    <img id="LongDescNotReq4" src="images/index.gif" border="0"
              alt="Index" /></a>
        </td>
        <td class="go-right">
          <span class="copyright">Porting MIDP <br /> MIDP Reference Implementation, Version 2.0 FCS</span>
        </td>
      </tr>
    </table>

    <p>&#160;</p>
    <p class="copyright"><a 
       href="copyright.html">Copyright</a> &#169;
       2002 Sun Microsystems, Inc. All rights reserved.</p>	
  </body>
</html>
